home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / doorware / clasfy43.zip / CLASSIFY.DOC < prev    next >
Text File  |  1996-09-10  |  49KB  |  1,073 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                              CLASSIFIED ADS
  11.  
  12.                                   v4.3
  13.  
  14.                                    by
  15.  
  16.                                Al Lawrence
  17.     
  18.                              Sunrise-80  BBS
  19.                    (404) 256-9525 (33.6 USR v.everything)
  20.                    (404) 705-9104 (33.6 USR v.everything)
  21.                  (404) 256-9518 (VOICE: 9am-9:30pm EST) any day
  22.                               FIDO 1:133/6003
  23.                         (EMAIL) al_lawre@ix.netcom.com
  24.  
  25.  
  26.  
  27.                  Copyright  1992 - 1996,   Al Lawrence
  28.                           All Rights Reserved
  29.  
  30.  
  31.                           Table of Contents
  32.                           -----------------
  33.  
  34.     Overview.......................................................... 1
  35.     Installation...................................................... 2
  36.     Configuration File Description.................................... 3
  37.     Restrictions...................................................... 4
  38.     Modify an Ad...................................................... 4
  39.     Download Ads...................................................... 4
  40.     Reading Ads Offline............................................... 5
  41.     NEWS Option (CLNEWS.TXT).......................................... 5
  42.     Topics File (CLTOPICS)............................................ 6
  43.     Usage Log......................................................... 6
  44.     Category File..................................................... 7
  45.     Welcome and Goodbye Files......................................... 8
  46.     'Pay to Advertise'................................................ 9
  47.     Purging Ads, Messages............................................. 10
  48.     Database Exchange................................................. 11
  49.     Setting up a Hub to Exchange files................................ 13
  50.     Non-Standard COM Support.......................................... 15
  51.     Multi-Node Setup.................................................. 16
  52.     File Transfer Protocols (PROTOCOL.DAT)............................ 17
  53.     File Compression (COMPRESS.DAT)................................... 18
  54.     Limiting Exports by Category (CLEXPORT.DAT)....................... 19
  55.     Maintenance Program (CLMAINT)..................................... 20
  56.     PrePaid Ads....................................................... 21
  57.     Credit Card Data Collection (CLCREDIT.TXT/CLCREDIT.DAT)........... 22
  58.     PICTURE File Compression (CLEXCMPR.DAT)........................... 22
  59.     Legalities........................................................ 23
  60.     Distribution...................................................... 23
  61.     Registration...................................................... 23
  62.     Misc.............................................................. 24
  63.  
  64.                                                                        Page 1
  65.                                 OVERVIEW
  66.                                 ________
  67.  
  68.  
  69.    The CLASSIFIED Ads Door is designed to allow callers to post Classified Ads
  70.    in any of the unlimited categories you have set up. You can designate each
  71.    category to be "FREE" or "PAY". "PAY" categories give you the option of
  72.    charging businesses/individuals for posting their ads; similar to your
  73.    local newspapers.
  74.  
  75.    Optionally, electronic pictures of the products being posted, can be
  76.    attached to an Ad for the caller to access. Please note that this option
  77.    requires an additional registration.
  78.  
  79.  
  80.  
  81.    NOTE: Most errors will be logged to a file called DFRAME.ERR which is
  82.          created in the Classified Door directory.
  83.  
  84.  
  85.  
  86.                                                                        Page 2
  87.                               INSTALLATION
  88.                               ____________
  89.  
  90.  
  91.    Installation is fairly easy and straight forward. The following steps and
  92.    examples should have you up and running in a very short period of time.
  93.    It is assumed that you are familiar with setting up DOORS on your system.
  94.    To this end, only examples of the configuration file and Door batch file
  95.    (if required by your BBS software) are described.
  96.  
  97.    **** SHARE.EXE is REQUIRED! Place the word SHARE on a line by itself ****
  98.    **** in your AUTOEXEC.BAT file, anywhere after your PATH statement.  ****
  99.  
  100.       1) Create a directory to hold all CLASSIFY files
  101.  
  102.       2) Unzip CLASFYxx.ZIP into the the above directory
  103.  
  104.       3) Create a configuration file, with a name of your choice, or modify
  105.          the supplied CLASSIFY.CFG file. You can do this manually with an editor
  106.          of your choice OR you can use the configuration option in the
  107.          Classified Ads Maintnenance program (CLMAINT). The configuration file
  108.          layout/description can be found further on in this document
  109.  
  110.       4) Create a batch file or modify the CLASSIFY file supplied (if your BBS
  111.          software requires the use of a batch file to execute the door). A
  112.          description of this file follows:
  113.  
  114.             ECHO off
  115.             cd\BBS\DOORS\CLASSIFY     Location of CLASSIFY files
  116.             CLASSIFY CLASSIFY.CFG     EXE filename and CFG filename (Name
  117.                                       used in creating file in #3 above)
  118.             CD\BBS
  119.             BOARD
  120.  
  121.  
  122.        5) When running more than one node, read MULTI-NODE SETUP further on
  123.           in this document.
  124.  
  125.  
  126.        6) Unzip CLBATCH.ZIP, which contains working batch files examples for
  127.           some popular protocols.
  128.  
  129.                                                                        Page 3
  130.                         CLASSIFIED ADS CONFIGURATION FILE
  131.  
  132.    **                       Location of system file (See Below)
  133.    SUNRISE-80 BBS           Your BBS Name
  134.    Al                       Sysop's First name
  135.    Lawrence                 Sysop's Last Name
  136. |-----------------------------------------------------------------------------|
  137. | READ!     1                        CommPort  \ These 2 lines are required   |
  138. | READ!     1                        Node #    / ONLY for GTUSER.BBS          |
  139. |-----------------------------------------------------------------------------|
  140.    00000000                 Registration Number
  141.  # 2                        Keyboard timeout value in Minutes
  142.  # NONE                     Drive:\Path\Filename to contain the ASCII Bulletin
  143.                             summarizing all Ads in the database
  144.  # NONE                     Drive:\Path\Filename to contain the COLOR Bulletin
  145.                             summarizing all Ads in the database
  146.  
  147.    Y                        Y=Display the Originating BBS Name, N = Do NOT
  148.  
  149.    N                        Y =  Use European Date Format (DDMMYY)
  150.                             N =  Use Regular  Date Format (MMDDYY)
  151.  
  152.    0                        Minimum Logon Security Level required to use the new
  153.                             AD option. Zero(0) will allow access to everyone.
  154.  
  155.    0                        Minimum Logon Security Level required to use the
  156.                             DELETE option. Zero(0) will allow access to everyone
  157.  
  158.    0                        Minimum Logon Security Level required to use the
  159.                             MODIFY option. Zero(0) will allow access to everyone
  160.  
  161.    0                        Minimum Logon Security Level required to use the
  162.                             MESSAGES option. Zero(0) allows access to everyone.
  163.  
  164.    00000000                 Ads Exchange Program Registration Number
  165.  
  166.    SUN80                    Name of the EXPORT file that is generated by the
  167.                             CLEXCH program. We suggest that it be a unique name.
  168.                             DO NOT include an extension! Maximum of 6 characters
  169.  
  170.    WELCOME                  Name of the WELCOME file. CAN contain an extension.
  171.  
  172.    GOODBYE                  Name of the GOODBYE file. CAN contain an extension.
  173.  
  174.    (Any Info You Wish)      Additional information about your BBS, that will be
  175.                             displayed with each Ad posted on your BBS. We
  176.                             suggest the use of the BBS telephone # as it is
  177.                             displayed adjacent to the Originating BBS Name.
  178.                             MAXIMUM of 25 characters.
  179.  
  180.    SYSOP                    BBS name the SYSOP uses when he/she logs on. When a
  181.                             caller enters an Ad in a PAY category, a message is
  182.                             sent to THIS name to notify the Sysop about the Ad.
  183.  
  184.    Y                        Y = Allow Downloading, N = NO Downloading
  185.  
  186.  
  187.   
  188.                    CLASSIFIED ADS CONFIGURATION FILE (Cont'd)
  189.    
  190.    
  191.    N                        Y = Allow use of HiASCII characters
  192.                             N = Do NOT allow the use of HiASCII characters
  193.  
  194.    0                        Min Security level allowed to view pictures
  195.  
  196.    N                        Y = YES Import/Export Picture Files
  197.                             N = Do NOT import/Export Picture Files
  198.  
  199.    c:\classify              FULL Drive:\Pathname to the Directory where
  200.                             Picture files are located. Entry MUST end with a \
  201.  
  202.    NONE                     Line of text you wish displayed at the top of the
  203.                             screen when adding or displaying an ad. Maximum of
  204.                             76 characters and if no text is to be displayed
  205.                             you must use the word NONE
  206.  
  207.    Y                        Y = When using Option 1 on Main menu, show ALL
  208.                                 Categories
  209.                             N = Show only Categories that contain Ads
  210.  
  211.    N                        Y = Use ALIAS in lieu of the BBS Logon Name.
  212.                                 (Requires DOOR.SYS)
  213.                             N = Use normal BBS LogonName
  214.  
  215.    Y                        Y = Log ALL callers to a node specific file, 
  216.                                 USAGEx where x is the node number
  217.                             N = Do not log callers
  218.  
  219. ** = Replace with a PATH to ONE of the following:
  220.         PCBOARD.SYS    CALLINFO.BBS   DOOR.SYS   GTUSER.BBS
  221.         DORINFOx.DEF   SFDOORS.DAT
  222.  
  223.   # = Requires registration to change to a different value.
  224.  
  225.                                                                        Page 4
  226.                             RESTRICTIONS!
  227.                             -------------
  228.  
  229.    UnRegistered versions of CLASSIFIED Ads have the following restrictions:
  230.  
  231.           . Maximum of 10 Messages may be entered
  232.           . Maximum of 15 Ads may be entered
  233.           . Purge option is disabled
  234.           . WELCOME file is not recognized
  235.           . GOODBYE file is not recognized
  236.           . Keyboard timeout value remains at 2 minutes
  237.           . Bulletin will not be generated
  238.           . Unable to Export Ads, Messages and Pictures
  239.           . PAY advertising not functional
  240.           . Picture Attachment (see REGISTRATION section of this document)
  241.  
  242.  
  243.  
  244.  
  245.                            MODIFYING an AD
  246.                            ---------------
  247.  
  248.    All Ads may be modified by the caller that entered the Ad or the Sysop of
  249.    BBS on which the Ad was entered. If you, as the Sysop, try to modify an Ad
  250.    that was not entered on your BBS, the program will revert back to the Main
  251.    Menu.
  252.  
  253.  
  254.  
  255.  
  256.  
  257.                            DOWNLOADING  ADS
  258.                            ----------------
  259.  
  260.    Callers may download Ads by choosing the appropriate option from the main
  261.    menu. Downloading is OPTIONAL and is controled via an option in the
  262.    configuration file. Therefore, if you decide not to allow your callers to
  263.    download, you may set the appropriate option to "N" in the configuration
  264.    file. If you do permit downloading, you MUST define the protocols and
  265.    compression formats you will be supporting on your board. (See Compression
  266.    Formats and File Transfer Protocols in this document).
  267.  
  268.  
  269.                                                                        Page 5
  270.                         READING DOWNLOADED ADS OFFLINE
  271.                         ------------------------------
  272.  
  273.    Your callers have the ability to download the Ads database and read them
  274.    offline. They must use the reader supplied with the Classified Ads Door,
  275.    called CLREADER.
  276.  
  277.    Optionally, the caller can send a message to the Ad poster and upload the
  278.    message(s) to the Classified Ads door, on a subsequent call.
  279.  
  280.    There is an option on the Main Menu that will allow your callers to Download
  281.    the CLREADER.EXE and CLREADER.DOC files. You must ensure that both files
  282.    exist in the Classified Ads Directory. The files MUST NOT be compressed
  283.    (ZIPed, etc) as the caller will be given the option to choose one of the
  284.    compression routines you have defined for use with Classified Ads.
  285.  
  286.  
  287.  
  288.                             NEWS  OPTION
  289.                             ------------
  290.  
  291.    This Main Menu option, called NEWS, allows the Sysop to have a file
  292.    displayed to the user, that will convey some type of message relative to
  293.    the Classified Ads or a Network the Sysop belongs to or hints/tips, etc to
  294.    make the use of the Classified Ads a little easier for the user.
  295.  
  296.    The filename MUST be called CLNEWS.TXT and if the file does not exist in the
  297.    CLASSIFY directory the program will disregard that Menu option, if chosen.
  298.  
  299.                                                                        Page 6
  300.                                TOPICS File (CLTOPICS)
  301.                                ----------------------
  302.  
  303.    
  304.    
  305.    Classified Ads allows you to define an unlimited number of Categories into
  306.    which callers enter their Ads. Although this provides your callers with a
  307.    wide variety from which to choose, it takes a long time to display these
  308.    Categories on the screen (especially at lower modem speeds).
  309.  
  310.    
  311.    
  312.    To this end we have taken the approach that we will consolidate categories
  313.    into TOPICS and allow the caller to choose from a maximum of 40 TOPICS. As
  314.    each TOPIC is chosen we display ONLY those Categories that YOU have
  315.    associated with that TOPIC.
  316.  
  317.    
  318.    
  319.    If you DO NOT want to present TOPICS to your callers (yes it is optional...)
  320.    don't create the CLTOPICS file and they will be presented with the Categories
  321.    directly. OR create an ASCII file called CLTOPICS and define each topic on a
  322.    separate line, EXACTLY as you want it displayed to the caller. Each line
  323.    can have a maximum of 35 characters and a maximum of 40 TOPICS.
  324.  
  325.    
  326.    
  327.    Categories are defined in the CLASSIFY.CAT file. One of the entries for
  328.    each Category is the TOPICS number. This number corresponds to the line
  329.    number within the TOPICS file you wish to link to this Category. See
  330.    CATEGORY FILE discussion elsewhere in the documentation.
  331.  
  332.  
  333.  
  334.                              USAGE LOG
  335.                              ---------
  336.  
  337. As an option, we provide you with the ability to log every player to a text 
  338. file. IF you enter Y in the CFG file to log callers, the Door will place the
  339. caller's name as well as the ON and OFF times each time a caller selects the
  340. Door. A separate file will be created for each Node and the name of the file
  341. will be USAGEx, where x is the Node number.
  342.  
  343. You may delete these files at any time and the Door will recreate them the
  344. next time a caller enters the Door. If you do NOT want to continue logging
  345. callers, change the CFG file entry to N.
  346.  
  347.                                                                        Page 7
  348.                         CATEGORY FILE (Classify.CAT)
  349.                         ----------------------------
  350.  
  351.  
  352.    **** PLEASE NOTE: You MUST run option 12 from the CLMAINT menu EACH and 
  353.                      EVERY time you make a change to the CLASSIFY.CAT 
  354.                      (Classified Category) file.
  355.  
  356.        
  357.        Be sure to give a lot of thought to your choice of categories, since
  358.        the category position in this file is carried in each Ad record. This
  359.        means, if you set up the categories so that #2 was 'Want Ads - General'
  360.        and the caller entered an Ad under that category, the Ad would carry
  361.        category #2 as the category number. If you then decide that you want to
  362.        change the 'Want Ad - General' category to say, 'Announcements', then
  363.        the Ads carrying #2 in their record would be classified incorrectly.
  364.  
  365.                The format of the Classify.Cat file follows:
  366.  
  367.                             SS,TTTTTTTT,UU,V,WW,XX,Y,Z
  368.  
  369.                Where s = Topic number from TOPICS file or 0 if you have
  370.                          chosen not to use TOPICS
  371.                      t = Category name. Max length: 25 characters(NO COMMAS)
  372.                      u = Maximum number of days a "FREE" ad can remain active.
  373.                          Min:1 Max 365 (This value is not used with "PAY"
  374.                          categories). Each "FREE" ad carries a purge date
  375.                          calculated by adding this value to the date the Ad
  376.                          was entered.
  377.                      v = Should the program ask for COST ($$$) info. You
  378.                          would answer Y for a For Sale type category and
  379.                          an N for a WANT AD or Announcment type category.
  380.                      w = Category security level to ENTER an AD. If caller's
  381.                          logon security level is less than this security level,
  382.                          they will not be able to enter an ad in this category.
  383.                          A category security level of 0 allows anyone to enter
  384.                          an Ad.
  385.                      x = Category security level to VIEW an Ad. If caller's
  386.                          security level is less than this security level, they
  387.                          will not be able to VIEW an Ad in this category. A
  388.                          category security level of 0 allows anyone to VIEW
  389.                          an AD.
  390.                      y  = Allow Ads to be downloaded from this conference.
  391.                          Y=yes, N=no
  392.                      z = 'Pay' Category:   P = Pay   F = Free
  393.  
  394.    The Classified Ads Door will check each category entry and will report
  395.    any errors it detects. Error numbers are defined as follows:
  396.  
  397.                1 = Category Name greater than 25
  398.                2 = Days to remain active is less than 0 or greater than 365
  399.                3 = COST field contains other than a Y or N
  400.                4 = Allow downloads field contains other than a Y or N
  401.                5 = PAY field contains other than a P or F
  402.                6 = The topic number is greater than the actual number of
  403.                    topics in the CLTOPICS file OR the CLTOPICS file was
  404.                    not found in the Classify directory.
  405.  
  406.                                                                        Page 8
  407.                         WELCOME and GOODBYE Files
  408.                         -------------------------
  409.       
  410.       
  411.       
  412.       The following applies to registered versions of CLASSIFY ONLY!
  413.  
  414.       
  415.       
  416.       You can define the name of the WELCOME file in the configuration file.
  417.       If the program finds that filename, it will display that file after
  418.       the opening screen and before the main menu screens. The file must
  419.       reside in the same directory as CLASSIFY.EXE
  420.  
  421.       
  422.       
  423.       You can define the name of the GOODBYE file in the configuration file.
  424.       If the program finds that filename, it will display that file when the
  425.       caller exits the program. It will display prior to displaying the file
  426.       called ADOPT.SYS (if you have created it). The file must reside in the
  427.       same directory as CLASSIFY.EXE
  428.  
  429.  
  430.                                                                        Page 9
  431.                        "PAY-TO-ADVERTISE" Option
  432.                         ________________________
  433.  
  434.       Classified Ads can be used to charge for the placement of an
  435.       advertisement and/or allow for the ads to be placed free of charge. You
  436.       decide which on a category-by-category basis.
  437.  
  438.       You make a category a 'PAY' category by changing the appropriate entry
  439.       in the Classify.Cat file from an "F" to a "P".
  440.  
  441.       You have the option to create an ASCII file that will be displayed to
  442.       the caller, everytime they choose a particular 'PAY' category in which
  443.       to enter an ad. This file can contain any pertinant information such
  444.       as the method of payment, information required, etc. If you want the
  445.       same file to be used for ALL 'PAY' categories, then you must name the
  446.       file "PAY" (no quotes). If you want to display a unique file for some
  447.       'PAY' categories, then you must name the file  "PAYx", where x is the
  448.       line number of the corresponding entry in the ClASSIFY.CAT filer. If
  449.       the program does not find a 'PAYx" for a particular 'PAY' category, it
  450.       will then search for a "PAY" file. If neither is found it will not
  451.       display anything. We strongly suggest that you create a file for display
  452.       for all 'PAY' categories so as to ensure that the callers understand the
  453.       guidelines you have established for 'PAY' categories.
  454.  
  455.       Any ads entered into a 'PAY' category, will remain INVISIBLE to everyone
  456.       until payment is received and the Sysop makes that ad VISIBLE. You must
  457.       use the appropriate option in the Classified Ads Maintenance program
  458.       (CLMAINT) to make an ad VISIBILE. Please note that INVISIBLE ads are NOT
  459.       exported!
  460.  
  461.       The  maintenance program (CLMAINT.EXE) will display EVERY ad in the
  462.       database that is flagged as INVISIBLE. You will have the choice of
  463.       BYPASSING it, DELETING it or making it VISIBLE. Once an ad is deleted or
  464.       made VISIBLE, it can not be reversed... so BE CAREFUL!
  465.  
  466.       Registered option only.
  467.  
  468.                                                                        Page 10
  469.                            AUTOMATED PURGING
  470.                            -----------------
  471.  
  472.       When you set up the categories to be used in your version of CLASSIFIEDS,
  473.       you are asked to define the number of days the ad should remain active.
  474.       By running the CLMAINT (PURGE option) program in your nightly event
  475.       process you will ensure that the ads are deleted, automatically.
  476.  
  477.       In addition to purging expired ads, the CLMAINT Purge option will pack
  478.       the message database
  479.  
  480.       The following is all that is required to execute the purge:
  481.  
  482.                          CLMAINT CLASSIFY.CFG /EVENT
  483.                                  ^^^^^^^^^^^^
  484.                                      |
  485.                                      |------ or your congfiguration file name
  486.  
  487.           Note: This is only available in registered versions!
  488.  
  489.  
  490.   
  491.                                                                        Page 11
  492.                            DATABASE EXCHANGE
  493.                            _________________
  494.  
  495.   ** A GREAT WAY TO SHARE THE CLASSIFIED ADS DATABASE BETWEEN 2 OR MORE BBS' **
  496.      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  497.       The optional Classified Ads Database Exchange feature will allow you
  498.       to participate in the exchange of Classified Ads databases (Ads and
  499.       Messages) BBS' (Any number of BBS' can participate). The exchange
  500.       program is named CLEXCH and comes included in the CLASFYxx.ZIP file.
  501.  
  502.       CLEXCH performs three (3) major functions:
  503.  
  504.      (1) EXPORT:  Extracts all active ads and messages from the Classified
  505.                   databases. It creates files named XXXXXXrr.AXP and
  506.                   XXXXXXrr.MXP (XXXXXX is defined in the CFG file, rr is a
  507.                   random letter/number combination) and will bypass any
  508.                   ad already flagged for deletion as well as those Ads that
  509.                   were previously exported.
  510.  
  511.      (2) IMPORT:  Imports files named XXXXXXrr.AXP and XXXXXXrr.MXP and
  512.                   XXXXXXrr.MXP (XXXXXX is defined in the CFG file, rr is a
  513.                   random letter/number combination) created by the EXPORT
  514.                   option and merges all ads and messages into the Classified
  515.                   databases. It will not import any ads or messages that
  516.                   duplicates ads or messages found in the existing databases.
  517.                   Note that this option will IMPORT ALL files with an extension
  518.                   of AXP and MXP, during a single execution of the program.
  519.  
  520.      (3) IMPEXP:  This option will first IMPORT (as in (2) above) then turn
  521.                   around and EXPORT (as in (1) above) during one execcution
  522.                   of the program.
  523.  
  524.      All BBS' involved in the exchange MUST run registered versions of BOTH
  525.      Classified Ads and Classified Exchange (CLEXCH).
  526.  
  527.      It is critical that ALL participants in the exchange use the SAME
  528.      Category file. Failure to do so will result in ads meant for a certain
  529.      category on one system, showing up in a category totally unrelated on
  530.      another system.
  531.  
  532.  
  533.  
  534.       N O T E:  To EXCLUDE certain categories from being exported see
  535.                 "Limiting Export by Category" elsewhere in this document
  536.  
  537.  
  538.  
  539.  
  540.                             (Continued on Next Page)
  541.  
  542.  
  543.                                                                        Page 12
  544.                         DATABASE EXCHANGE (Continued)
  545.  
  546.  
  547.      To run the Exchange you do the following:
  548.  
  549.     ************************************************************************
  550.     * >>>>> If you are acting as a HUB you MUST signal CLEXCH.EXE by using *
  551.     *       HUBEXPORT, HUBIMPORT or HUBIMPEXP in lieu of EXPORT, IMPORT or *
  552.     *       IMPEXP. If you fail to do this you will not be able to export  *
  553.     *       newly imported Ads/Messages.                                   *
  554.     ************************************************************************
  555.  
  556.      EXPORT:  a) Change to the directory containing your CLASSIFY.DAT file
  557.               b) Issue this command:  CLEXCH EXPORT CLASSIFY.CFG
  558.                  If you use a different name for your Config file, then
  559.                  substitute that name for CLASSIFY.CFG
  560.               c) Send (transmit) ALL *.AXP and *.MXP files to those involved
  561.                  in the exchange or to the HUB.
  562.               d) Delete ALL .AXP and .MXP files
  563.  
  564.      IMPORT:  a) Change to the directory containing your CLASSIFY.DAT file
  565.               b) Copy the *.AXP and *.MXP files that were sent to you by the
  566.                  BBS you are exchanging with, to the directory used
  567.                  in item (a) above.
  568.               c) Issue the command:   CLEXCH IMPORT CLASSIFY.CFG
  569.                  If you use a different name for your Config file, then
  570.                  substitute that name for CLASSIFY.CFG
  571.               d) Delete ALL *.AXP and *.MXP files
  572.  
  573.      IMPEXP:  a) Change to the directory containing your CLASSIFY.DAT file
  574.               b) Copy the *.AXP and *.MXP files that were sent to you by the
  575.                  BBS you are exchanging with, to the directory used
  576.                  in item (a) above.
  577.               c) Issue the command:   CLEXCH IMPEXP CLASSIFY.CFG
  578.                  If you use a different name for your Config file, then
  579.                  substitute that name for CLASSIFY.CFG
  580.               d) Send (transmit) ALL *.AXP and *.MXP files to those involved
  581.                  in the exchange or to the HUB.
  582.  
  583.  
  584.    NOTE: If you wish to EXPORT ALL Ads in the database regardless of whether
  585.          they have been previously exported, you can use the /ALL switch on
  586.          the CLEXCH command line. It can only be used with HUBIMPORT,
  587.          HUBEXPORT or HUBIMPEXP and MUST be the last entry on the command line.
  588.  
  589.    NOTE: When registering CLEXCH, you MUST use the EXACT SAME Sysop Name
  590.          AND BBS NAME as used for CLASSIFIED ADS!!!!!!!!!!!!!!!!!!!!!!!!!
  591.  
  592.    NOTE: All IMPORT and EXPORT transactions are now recorded in a
  593.          file called CLEXCH.LOG. If the file exists it will append
  594.          the information, if not it will create the file and add
  595.          the information. Thus you are free to delete it at any time.
  596.  
  597.  
  598.                                                                        Page 13
  599.          HOW TO SETUP AS A HUB AND DO CLASSIFIED ADS EXCHANGES
  600.          -----------------------------------------------------
  601.  
  602. Below, is a fully working batch file complete with comments, for the group
  603. hub. There are a few very important things to remember in running the
  604. Classified Ads as a hub.
  605.  
  606. FIRST, make sure all your nodes have the same categories or mass confusion
  607. will result. SECOND, it is highly advisable that you and your nodes use a
  608. unique name (representative of your board) instead of the generic
  609. "Classify.exp", for example Sun.exp would be the name for Sunrise BBS.
  610. THIRD, this batch file (Exchange.bat) is best run during your event each
  611. night, rather than each time the door is executed, especially if you are
  612. connected to boards that are long distance. The commands for your nightly
  613. event batch file would be:
  614.  
  615. CD\CLASSIFY
  616.    CLPURGE CLASSIFY.CFG
  617.    CALL EXCHANGE.BAT
  618.    DEL CLASSIFY.EXP
  619. CD\
  620.  
  621. Exchange.bat would be located in your classified directory and would be the
  622. batch file listed below. You may feel free to remove the comments and use
  623. the batch file below after modification for your system drive/path/name
  624. specifications.
  625.  
  626.  
  627.  
  628.  
  629.  
  630.                      (Continued on Next Page)
  631.  
  632.  
  633.                                                                        Page 14
  634.  
  635.                        HUB SETUP (Continued)
  636.  
  637.  
  638. _______________________________________________________________________________
  639. BATCH FILE EXAMPLE FOR THE HUB USING THE CLASSIFIED ADS EXCHANGE PROGRAM
  640.  
  641.  
  642.  
  643. @echo off
  644. del I:\db\files\classify.exp
  645.     ^  ^^ ^^^^^
  646. Comment: Above would be the drive/path to your inbound/outbound files directory.
  647.          This command will delete your previous night's export. NOTE: DO NOT
  648.          use this command the first night you start the import/export with
  649.          other boards.
  650.  
  651. cd\db\files
  652.    copy *.exp I:\ra\doors\classify
  653.         ^^^^^
  654.    del *.exp
  655.        ^^^^^
  656.  
  657. Comment: Copy all exported files sent to you into your classified directory,
  658.          then delete all the exported files. FAILURE to use a unique .exp
  659.          name will result in files over writing and only the last .exp file
  660.          copied will be imported into your database.
  661.  
  662. cd\ra\doors\classify
  663.    clexch IMPEXP classify.cfg
  664.                  ^^^^^^^^^^^^
  665.    copy classify.exp i:\db\files
  666.         ^^^^^^^^^^^^    ^^ ^^^^^
  667.  
  668. Comment: Perform the import/export (IMPEXP) then copy the resulting export file
  669.          from your classify directory to your outbound files directory.
  670.  
  671. cd\db
  672.    dbutil i send 1:114/203 i:\db\files\classify.exp
  673.    ^^^^^^
  674.  
  675. Comment: Send the export file to the other boards. Note above that the command
  676.          used is for D'Bridge...you may substitute the proper command and
  677.          outbound files directory for your front end mailer. You will need to
  678.          do an export for every BBS connected to you.
  679.  
  680.     __________________________________________________________
  681.    | This example provided to you courtesy of: Window In Time |
  682.    |                                           1:114/203      |
  683.    |                                           602-253-1946   |
  684.    |                                                          |
  685.    |  Feel free to contact the Sysop of Window In Time!!!!    |
  686.    |__________________________________________________________|
  687.  
  688.  
  689.  
  690.  
  691.                                                                        Page 15
  692.                         NON-STANDARD COM SUPPORT
  693.                         ________________________
  694.  
  695.       Support for COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  696.       COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  697.       number after the configuration filename. Let's assume your Door is
  698.       called FOOBAR and you want to use COM1 and IRQ5. The command line
  699.       passed to your Door would be:
  700.  
  701.                             FOOBAR FOOBAR.CFG /5
  702.  
  703.       The /5 tells FOOBAR to use IRQ5 rather than the standard IRQ4 that is
  704.       normally used with COM1. No /x parameter is needed for the standard
  705.       IRQ's.
  706.  
  707.       As an alternative, you may use an environmental variable on the command
  708.       line. To use the variable (following the example above), place a
  709.       SET IRQ=5 in the batch file used to bring up your BBS (you would need a
  710.       different IRQ number for each node). The command line would now look
  711.       like this:
  712.  
  713.                           FOOBAR FOOBAR.CFG /%IRQ%
  714.  
  715.       This, in combination with the use of the environmental variables
  716.       described in the MULTI-NODE SETUP section will allow you to use one
  717.       batch file and one config file to run this door on all nodes.
  718.  
  719.  
  720.  
  721.   
  722.                                                                        Page 16
  723.                            MULTI-NODE SETUP
  724.                            ________________
  725.  
  726.       All Sunrise Doors are Multi-Node capable. Each node must have the
  727.       ability to access a configuration file which will have its own system
  728.       file (DORINFOx.DEF, PCBOARD.SYS, DOOR.SYS, etc) defined on the first
  729.       line. There are 2 ways to accomplish this:
  730.  
  731.       (1) Create a separate configuration file for each node. The only
  732.           difference between each file would be the location of the system
  733.           file for that particular node. For example, on my system there are 2
  734.           nodes and the first line of the config files would look like this:
  735.  
  736.                         NODE1:  H:\PCB1\DOOR.SYS
  737.                         NODE2:  H:\PCB2\DOOR.SYS
  738.  
  739.           Thus, if you have a 4 node BBS, you will need 4 configuration files.
  740.  
  741.       (2) Use ONE configuration file for ALL nodes. This Door will recognize
  742.           the following PCBoard/Wildcat environmental variables:
  743.  
  744.                  PCBDIR    (Directory containing the System file)
  745.                  PCBDRIVE  (Drive containing the System file)
  746.                  WCNODEID  (Active Node Number)
  747.  
  748.           Thus, the first line of the SINGLE configuration file, for this Door
  749.           would look like this:
  750.  
  751.                         %PCBDRIVE%%PCBDIR%\DOOR.SYS
  752.                         c:\wc30\wcwork\node%wcnodeid%\door.sys
  753.  
  754.       NOTE: This option, as described, assumes that you are running PCB or
  755.             Wildcat software. The environmental variables are automatically
  756.             created by the software for each node.
  757.  
  758.             HOWEVER, if you are running other BBS software you should be able
  759.             to set the variables EXACTLY as described below, for EACH node
  760.             (more than likely in each batch file you use to bring up EACH node):
  761.  
  762.                             PCBDRIVE=C:
  763.                             ^^^^^^^^^
  764.                             PCBDIR=\NODE2
  765.                             ^^^^^^^^
  766.  
  767.             Info with a carat (^) under it, MUST be typed as is. The rest
  768.             depends on your naming conventions.
  769.  
  770.             This, in combination with the use of the optional environmental
  771.             variable described in the NON-STANDARD COM SUPPORT section, will
  772.             allow you to use one batch file and one config file to run this
  773.             door on all nodes.
  774.  
  775.  
  776.  
  777.                                                                        Page 17
  778.                    UPLOAD/DOWNLOAD FILE TRANSFER PROTOCOLS
  779.                    ---------------------------------------
  780.  
  781.       Classified Ads externalizes all file transfer protocols used for Uploading
  782.       and Downloading of the Classified Ads. This allows the Sysop to define the
  783.       file transfer protocols they wish to support.
  784.  
  785.       A file called PROTOCOL.DAT is supplied with protocols already defined,
  786.       which you may alter at any time. Each entry in the PROTOCOL.DAT file
  787.       consists of the description that will be displayed to the caller on the
  788.       Protocol Menu and the 'high level' name of the protocol's batch files.
  789.  
  790.                Example:  ZModem   Upload or Download, ZPROT
  791.  
  792.       The information to the left of the comma is the description. Classified
  793.       requires that you have 2 batch files in the Classified directory to handle
  794.       the uploading and downloading. In the above example ZPROT is the 'high
  795.       level' portion of the 2 batch file names required for ZMODEM. Your
  796.       Classified directory should contain ZPROTR.BAT (the R is for uploading)
  797.       and ZPROTS.BAT (the S is for downloading). The R and S suffixes MUST be
  798.       present as that is what Classified Ads will be looking for in the
  799.       Classified Ad directory!
  800.  
  801.       Each protocol batch file MUST contain 2 batch file variables as follows:
  802.  
  803.       %1 = Classified will use this variable to substitute the current ComPort
  804.       %2 = Classified will use this variable to substitute the file name
  805.  
  806.       IMPORTANT! Place the variable (%1 and %2) ONLY in the EXACT location that
  807.                  your protocol requires them, in the protocol command line. Do
  808.                  NOT supply the ComPort or FileName, JUST the %1 and %2
  809.                  variables themselves (%1 and %2)!
  810.  
  811.       See example batch files supplied with the Classified. They are the ones
  812.       being used on the Sunrise-80 BBS.
  813.  
  814.                              *** PLEASE NOTE ***
  815.  
  816.       There may come a time when you will need to supply information to the
  817.       protocol you are using, based on the node it will be used on. You can
  818.       accomplish this by supplying a node-specific PROTOCOL file. Everything
  819.       described above stays the same except that you will name the file
  820.       PROTOCOL.x (where x is the node number). For example, to use a special
  821.       set of protocols (or batch files) on node number 5, modify a copy of
  822.       PROTOCOL.DAT and name it PROTOCOL.5. CLASSIFY will use PROTOCOL.5 when
  823.       someone logs on node 5 and will use PROTOCOL.DAT for ALL OTHERS. You do
  824.       not have to create node-specific PROTOCOL files for all nodes.. just the
  825.       node(s) that are different.
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.                                                                        Page 18
  838.  
  839.                     FILE COMPRESSION (COMPRESS.DAT)
  840.                     -------------------------------
  841.  
  842.    When a caller chooses to download a file of any kind, from Classified Ads,
  843.    they are presented with a list of compression types from which to choose.
  844.  
  845.    A file called COMPRESS.DAT is supplied with several types already defined.
  846.    You are free to alter the file to reflect the ones you support. Each entry
  847.    in the COMPRESS.DAT file consists of the description that will be displayed
  848.    to the caller on the Compression Menu, the name of the compression file
  849.    name and the command used to add files to the archive.
  850.  
  851.      EXAMPLE:
  852.                  PKZip  v1.10,PKZIP -a
  853.                  ARJ    v2.3,ARJ a
  854.  
  855.  
  856.    Please note that everything to the left of the comma is part of the
  857.    description for that compression type and may be modified to your liking.
  858.  
  859.  
  860.                                                                        Page 19
  861.  
  862.                      LIMITING EXPORTS BY CATEGORY
  863.                      ----------------------------
  864.  
  865.    By default the CLEXCH (Classified Exchange) program will export ads in ALL
  866.    categories. If you wish to limit the categories that will be exported,
  867.    create an ASCII file and call it CLEXPORT.CAT and enter the category
  868.    number(s) you DO NOT want to export, ONE to a line. The category number is
  869.    the line position of the category as it exists in the CLASSIFY.CAT file.
  870.  
  871.    For example, if the CLASSIFY.CAT file contained:
  872.  
  873.              Local For Sale
  874.              National For Sale
  875.              Local Announcements
  876.              National Announcements
  877.  
  878.    and you did NOT want to export local categories, you would create
  879.    CLEXPORT.CAT and input the following in the file:
  880.  
  881.    1
  882.    3
  883.  
  884.    Those 2 entries in the CLEXPORT.CAT would tell CLEXCH to NOT export the
  885.    "Local For Sale" and "Local Announcements" categories.
  886.  
  887.  
  888.                                                                        Page 20
  889.  
  890.                     MAINTENANCE PROGRAM (CLMAINT)
  891.                     -----------------------------
  892.  
  893.    The Classified Ads Maintenance program, CLMAINT.EXE, is a menu driven
  894.    program used to perform the following functions:
  895.  
  896.    (1) Maintain the PREPAID Ads file
  897.        . Add/view/delete prepaid ads entries in the PREPAID file
  898.  
  899.    (2) Database PURGE
  900.        .Will purge Ads, Messages and Prepaid Ads entries from their
  901.         respective files if they are marked for deletion.
  902.  
  903.    (3) View/maintain the Invisible Paid ads
  904.        .When an ad is entered into a PAID category, it is made invisible
  905.         (not displayable) until you manually make it visible. This option
  906.         allows you to do this or you can view and/or delete it
  907.  
  908.    (4) Setup the Classified Ads configuraiton file
  909.        .Use this option to setup or modify a configuration file.
  910.  
  911.    (5) Reset the EXPORT flag of ALL Ads in the database
  912.        .Use this option to force ALL ads in the Ads database to be marked for
  913.         Export the next time you run CLEXCH.
  914.  
  915.    (6) Reset the EXPORT flag of ALL Messages in the database
  916.        .Use this option to force ALL messages in the Message database to be
  917.         marked for Export the next time you run CLEXCH.
  918.  
  919.    (7) Create/Update the CLassify.CNT file. This fiel keeps track of the 
  920.        number of Ads in each category.
  921.  
  922.    (8) Transfer Ads from one Category to another (must run option 12 as well)
  923.  
  924.  
  925.    Execution examples:
  926.  
  927.       CLMAINT CLASSIFY.CFG               <===== Manual
  928.  
  929.              or
  930.  
  931.       CLMAINT CLASSIFY.CFG /EVENT        <===== Auto purge from an Event
  932.  
  933.                                                                        Page 21
  934.  
  935.                            PRE-PAID ADS
  936.                            ------------
  937.  
  938.    This option will allow you to accept payment for ads in advance. Using the
  939.    PREPAID ads option in the maintenance program (CLMAINT.EXE), you can add,
  940.    view or delete entries in the PREPAID file. The PREPAID file will contain
  941.    the name of the caller, the Ad display time (Week/Month/Quarter/Year) and
  942.    the number of ads they have prepaid for that type of Ad.
  943.  
  944.    You must have a separate entry for each display time type for each caller.
  945.    For example, a caller named Joe Door can prepay for 2 Monthly Ads and 3
  946.    Weekly Ads. In this case you would need 2 Joe Door entries in the PREPAID
  947.    file, one for the WEEKLY Ads and 1 for the Monthly Ads.
  948.  
  949.    When the caller enters an Ad in a PAY category, Classify asks what length
  950.    of time the Ad should run. If the program finds a match in the PREPAID file,
  951.    (on caller name and display time) it will make the Ad VISIBLE, IMMEDIATELY
  952.    and decrement the number of Pre-Paid Ads by 1.
  953.  
  954.    When the Purge option in CLMAINT is run (Manually or as an Event) entries
  955.    in the PREPAID file with a zero in the number of ads filed, will be deleted.
  956.  
  957.  
  958.    
  959.                                                                        Page 22
  960.                                                                        
  961.                     CREDIT CARD DATA COLLECTION                                                                       
  962.                     ---------------------------                                                                       
  963.                     
  964.  
  965.    Classified Ads can optionally accept credit card information from those 
  966.    callers placing "PAID" Ads. This option will be in effect IF the program 
  967.    finds a file named CLCREDIT.TXT in the Classified directory. This file can 
  968.    contain a maximum of 20 questions that you wish the caller to answer 
  969.    relative to their credit card. The maximum length of any line in the file is
  970.    38 characters and the number of characters the caller may respond with is 40. 
  971.    You may format each line any way you wish as long as the above criteria is 
  972.    adhered to. 
  973.    
  974.    A file named CLCREDIT.DAT will be created and will contain all information 
  975.    entered by the caller, along with other pertinent information about the Ad 
  976.    posted. The information from each caller will be APPENDED to the file and 
  977.    it is the Sysop's responsibility to delete that file when they have captured 
  978.    the information. A sample CLCREDIT.TXT file is included in the archive. 
  979.    Should you NOT want to accept credit cards then YOU must either delete the 
  980.    CLCREDIT.TXT file or rename to some other name for future use.
  981.    
  982.    
  983.    
  984.    
  985.                      PICTURE FILE COMPRESSION (CLEXCMPR.DAT)
  986.                      ---------------------------------------
  987.  
  988.  
  989.     To facilitate the Exchange of PICTURE files we must compress them all into 
  990.     ONE file. To this end we use a file called CLEXCMPR.DAT to define the names 
  991.     of the BATCH files that will be used. The CLEXCMPRS.DAT file supplied 
  992.     contains the names of 2 batch files called ZIPIT.BAT and UNZIPIT.BAT. As 
  993.     the names imply, one is used to ZIP up the PICTURE files and the other is 
  994.     used to UNZIP the PICTURE files.
  995.  
  996.     The 2 batch files can be changed to reflect another type of compression 
  997.     software, other than PKZIP. Each of the supplied batch files should be 
  998.     self-explanatory so as to allow changes (however we do recommend that they 
  999.     remain as supplied if at all possible).
  1000.    
  1001.    
  1002.                                                                        Page 23
  1003.                               LEGALITIES
  1004.                               __________
  1005.  
  1006.  
  1007.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  1008.       WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  1009.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  1010.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  1011.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  1012.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  1013.       OR BREACH OF ANY WARRANTY.
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.                              DISTRIBUTION
  1022.                              ____________
  1023.  
  1024.    You may make this file available for downloading from your BBS or you may
  1025.    upload it to any BBS of your choice, provided that you do not make any
  1026.    changes to the contents of the archive (ZIP file). The archive and its
  1027.    individual contents may not be used by any service that charges any money
  1028.    whatsoever, without the written permission of the author.
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.                              REGISTRATION
  1038.                              ____________
  1039.  
  1040.    Registration and the subsequent insertion of the registration number into
  1041.    your configuation file, will remove all restrictions deined in the section
  1042.    called "Restrictions', allows for the display of your BBS name on the
  1043.    opening and closing screen
  1044.  
  1045.    To register your copy of CLASSIFY, please fill out the registration form
  1046.    (REGISTER.FRM) and mail it along with the registration fee to the name
  1047.    and address on the form.
  1048.  
  1049.    Please note that you there is a choice of registering CLASSIFIED ADS with or
  1050.    without the ability to attach Pictures to to posted Ads!
  1051.  
  1052.    Once a door is registered, any changes to registration information (Sysop
  1053.    name or BBS Name) will require the doors to be re-registered at the
  1054.    registration fee in effect at that time.
  1055.  
  1056.    Be sure to use the proper upper/lower case when filling in your name and
  1057.    BBS name, as they MUST match the way you entered them in the configuration
  1058.    file.             ^^^^
  1059.  
  1060.    Based upon information supplied on the registration form, I will pre-
  1061.    register you on my BBS. You will then be able to call SUNRISE-80 and pick
  1062.    up your registration number OR you can enclose a SASE with the form/check.
  1063.  
  1064.                                                                        Page 24
  1065.                                  MISC
  1066.                                  ____
  1067.  
  1068.    The latest version of CLASSIFIED ADS and other fine SUNRISE DOOR programs
  1069.    are always available for download from SUNRISE-80 BBS.
  1070.  
  1071.    Remember, should you have any problems, questions or suggestions, be sure
  1072.    to drop me a message on Sunrise-80 or EMAIL.. address above.
  1073.